@filigran/chatbot 3.9.1 → 3.10.0

package/README.md

@@ -71,7 +71,9 @@ import { ChatPanel } from '@filigran/chatbot';
 | `apiBaseUrl`        | `string`                                  | **required** | Base URL for chat API endpoints                                  |
 | `user`              | `{ firstName: string }`                   | **required** | Current user info                                                |
 | `topOffset`         | `number`                                  | `0`          | Top offset in pixels (for sidebar/fullscreen with fixed headers) |
-| `agentDashboardUrl` | `string`                                  | —            | URL for "Browse agents" / "Create agent" links                   |
+| `agentDashboardUrl` | `string`                                  | —            | XTM One URL for the "Browse agents" / "Create agent" links and the waiting panel's "Play Space Invaders in XTM One" link (`{url}/chat?arcade=play`, http(s) only) |
+| `miniGameEnabled`   | `boolean`                                 | `true`       | Show the waiting panel during longer waits: rotating messages and the invitation to play XTM One's arcade (the package ships no game of its own) |
+| `onPlayWaitingGame` | `() => void`                              | —            | Open the arcade in place instead of linking to XTM One, for a host that runs it itself (the XTM One floating assistant) |
 | `t`                 | `(key: string) => string`                 | identity     | Translation function for i18n                                    |
 | `accentColor`       | `string`                                  | `'#7b5cff'`  | Primary accent color (hex)                                       |
 | `logoIcon`          | `React.ReactNode`                         | default icon | Custom logo/icon for the assistant                               |
@@ -708,19 +710,19 @@ Every key the package can ask for, grouped by where it appears:
 - `'the agent'`
 - `'{tool} (+{count} more)…'`
 
-**Waiting mini-game**
+**Waiting panel**
 
 - `'Almost there'`
 - `'Analyzing the details'`
 - `'Connecting the dots'`
 - `'Consulting the sources'`
 - `'Crunching the data'`
+- `'Play Space Invaders'`
+- `'Play Space Invaders in XTM One'`
 - `'Polishing the answer'`
 - `'Putting it together'`
 - `'Reticulating splines'`
 - `'Thinking it through'`
-- `'Turn off the waiting mini-game'`
-- `'Turn on the waiting mini-game'`
 - `'Wrapping things up'`
 
 **Reasoning details**

package/dist/index.d.ts

@@ -245,6 +245,11 @@ interface ChatPanelProps {
     apiBaseUrl: string;
     /** Custom API endpoint configuration. */
     apiEndpoints?: ApiEndpoints;
+    /**
+     * The XTM One URL: the header's "Browse agents" / "Create agent" links, and
+     * the waiting panel's invitation to play the arcade there
+     * (`{agentDashboardUrl}/chat?arcade=play`). Only an http(s) URL is linked.
+     */
     agentDashboardUrl?: string;
     user: {
         firstName: string;
@@ -314,12 +319,17 @@ interface ChatPanelProps {
      */
     backendType?: BackendType;
     /**
-     * Show the waiting experience during longer waits: dynamic rotating status
-     * messages plus an optional Space Invader mini-game that shoots the message
-     * letters away one by one. Users can still toggle the game off per browser
-     * from the panel; this prop is a host-level master switch. Default: true.
+     * Show the waiting panel during longer waits: rotating status messages and
+     * an invitation to play XTM One's Space Invaders arcade, in a new tab
+     * through `agentDashboardUrl` or in place through `onPlayWaitingGame`. The
+     * package ships no game of its own. Host-level master switch. Default: true.
      */
     miniGameEnabled?: boolean;
+    /**
+     * Opens the arcade in place instead of linking to XTM One, for a host that
+     * runs it itself (the XTM One floating assistant). Wins over the link.
+     */
+    onPlayWaitingGame?: () => void;
     /**
      * Notify the user when a long-running turn finishes while they are not
      * watching the chat — away (tab hidden / another window) via a document-title